KCSetDefaultKeychain

KCSetDefaultKeychain
Header:	Keychain.h		Carbon status:	Under Evaluation

Sets the default keychain.

OSStatus KCSetDefaultKeychain (
    KCRef keychain
);

Parameter descriptions

keychain: A reference to the keychain you wish to make the default.

function result: A result code. The result code errKCNoSuchKeychain indicates that the specified keychain could not be found. The result code errKCInvalidKeychain indicates that the specified keychain is invalid.

DISCUSSION

In most cases, your application should not need to set the default keychain. You should call the KCSetDefaultKeychain function to change where a password or other keychain items are added.

KCSetDefaultKeychain will automatically call the function KCUnlock to display the Unlock Keychain dialog box if the keychain you wish to make default is currently locked.

VERSION NOTES

Available beginning with Keychain Manager 1.0.